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Title: Disc Object Module Library Maintenance Routine 

(DOMLMR) 

Author: William R. Jones - RCA 

Cleveland District 
Suite 1605 

250 East Broad Street 
Columbus, Ohio 43215 
(614) 464-0400 

Date: September 21, 1970 



Description: DOMLMR maintains an Object Module Library (OML) , 

on a 70/564 or 70/590 disc unit, in a format 
acceptable to the RCA Linkage Editor (LNKEDT) 
utility. DOMLMR will add, delete, and replace 
individual or groups of modules without the 
need to replace the entire disc resident library. 
Because of a difference in format between a 
disc OML created by the Call Library Trans- 
criber Routine (CLTR) and DOMLMR, this utility 
will not maintain the master OML. Any attempt 
to update the master OML with DOMLMR will re- 
sult in an error message and program termina- 
tion. 

The disc area used by DOMLMR must begin at 
cylinder 1, track zero, and may extend thru 
cylinder 200 on a 70/564 or 70/590. The mini- 
mum allocation is two cylinders. After alloca- 
tion of the disc area with the RCA utility 
Random Access Storage Allocator (RAALLR) , the 
area is preformatted by the PREOML program 
provided with this package. The allocated 
disc area may be increased at any time by 
running RAALLR, followed by PREOML. 

The input to DOMLMR is an OML - the output 
from the Object Module Library Update routine 
(OMLU) . Three standard OMLU control cards may 
be used to convert an Object Module File (OMF) 
from a language translator (SYSUTl) to an OML, 
These three control cards will convert a single 
or multiple module SYSUTl. 
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Deletion of modules from the disc OML Is 

accomplished via a console message. The 
program will request the names of modules to 
delete when it is run outside of monitor. 
Up to an 80 character message is accepted from 
the console which consists of variable length 
(1 to 8 characters) module names separated by 
commas. In addition to module names, two 
special meaning operands may be entered: 

$STOP - If this operand is used, it must 
be the last entry. This operand 
specifies no input tape. When it 
is recognized in the parameter 
string, the program goes to normal 
termination. 

$PRINT- This operand causes a listing of 
the names of all the modules con- 
tained in the OML. 

When existing modules are deleted from the OML, 
all the records used by that module are released 
for subsequent use. For this reason, no file 
re-organization is required. When a later 
version of a module is transcribed to the OML, 
the module is technically deleted from the 
file and then re-entered as an addition. This 
allows the size of the module to change with- 
out regard for the original area occupied. 

DOMLMR will not properly catalog a module con- 
taining a sort due to the fact that OMLU does 
not convert all of the required information 
contained on SYSUTl. If an attempt is made 
to convert and catalog a module containing a 
sort, OMLU will reflect the omitted informa- 
tion in on error listing, produce an OMF and 
DOMLMR will catalog OMLU's output without warn- 
ing. Such a cataloged module will not link 
properly and should be deleted from the disc 
OML. 

Backup for an OML maintained by DOMLMR is 
provided by the RCA utility Disc Dump and Re- 
load (DDRL) , Once a module is ca ta loged into 
the OML, there is no way to retrieve it 
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except via LNKEDT, There is no facility to 
extract any particular module £rom the file 
for subsequent storage on tape or punched 
cards. 

DOMLMR and PREOML contain a constant which 
reflects the volume serial number of the disc 
containing the OML. For this reason, no run 
time parameters are required for proper device 
assignment. The only program change required 
is setting these values which are at a tag 

The user must bear in mind that subsequent 
software releases may render certain cata- 
loged modules unusable due to changes to the 
language translators that modify generated 
coding. The main area of concern is code 
generated for FCP and by COBOL for the 'CALL' 
and 'RETURN' verbs. As changes of this type 
are seldom, they do not pose a serious pro- 
blem for DOMLMR users. 

The storage capacity is: 

70/590 - 4 records per track - 

1688 bytes per records 
70/564 - 3 records per track - 

1129 bytes per record 

Cylinder one tracks zero thru eight contain 
the Object Module Directory - one 16 byte 
entry for each module contained in the library: 

70/590 - 105 entries per record 

3778 entries maximum (note 1) 

70/564 - 70 entries per record 

1888 entries maximum (notes 1 and 2) 

Cylinder one, track nine, contains the DOMLMR 
control record. 

Cylinder one, tracks eleven thru nineteen, 
for 70/590 are not used. 

Cylinder two thru the last cylinder in the 
extent contain the data records or actual modu- 
les. Each module will require at least two 
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of these records for storage. The data records 
are fixed length of 1688 or 1129 bytes to 
facilitate update writes to the disc; however, 
the data contained in them is variable length. 

Note 1 - Two of the entries in this 
area are control entries, 
the first one and the last 
one. 



Equipment: 



Memory 
Required: 

Source 
Language: 

Input Data 
Format: 



Note 2 - The 70/564 does not use the 
last byte of the 1129 byte 
directory record. 

The PREOML and DOMLMR routines are programmed 
for both 70/590 and 70/564 support. The 
device used is determined by the assignment 
made. No program changes are required. 

If DOMLMR terminates abnormally, it cannot 
be run again until the disc extent has been 
re-established by DDRL. Access is still 
possible by LNKEDT. 

One tape station for input (SYSUT2) . 

One disc drive with the 'Object Module Lib' 

extent. 

One printer if the $PRINT option is used in 
reply to the 'MODULES TO DELETE ?' message. 



Approximately 17,000 bytes. 



Assembly 



The input to DOMLMR is an OML formatted as 
described in the TOS Utilities Manual 70-35-302, 
Parameter cards are not required for this pro- 
gram. The names of modules to delete from the 
disc OML are accepted from the console when 
the utility is run outside of monitor. The 
•operating Procedures' section of this narra- 
tive describes the format and options for 
the console request. 
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The output of DOMLMR is described in appendix 
A of this narrative. Appendix A also corrolates 
the Input fields that are used with the output 
format on disc. 

The amount of time required to read the tape 
and transcribe it to disc. 

1. PREOML and DOMLMR are available as source 
card decks. 

2. I would be glad to answer any questions 
regarding DOMLMR for any interested party. 



1, Allocate disc area for a file named 

' OBJECT MODULE LIB' . This area must begin 
on cylinder one, track zero, and consist 
of at least two full cylinders. Only full 
cylinder allocation is acceptable to the 
DOMLMR system. The extent must consist 
of contiguous cylinders. 

2. Change the volume serial number in the DC 
entry called 'NAME3' of both the DOMLMR 
and PREOML programs to reflect the volume 
serial numbers allocated in Step 1. 

3, Assemble and run the PREOML program. The 
'STOP CONDITIONS' portion of this narra- 
tive explains the typeouts produced. No 
parameters are required. 

4. Assemble and transcribe the DOMLMR program 
to the master 'PGMLIB' on the executive 
disc. The system is now ready for use. 



From time to time it may be necessary to 
increase the size of the extent allocated as 
the OML. This can be accomplished by running 
RAALLR to de-allocate (not purge) the extent 
and then to re-establish it. Following the 
RAALLR run, PREOML must be run to update the 
control record to reflect the change prior to 
running DOMLMR. The 'STOP CONDITIONS ' portion 
of this narrative explains the typeouts pro- 
duced by PREOML. It is recommended that DDRL 
be run to provide a tape backup for the extent 
immediately after PREOML has been run. 

DOMLMR may be run as part of a monitor job 
stream or independently under the TDOS execu- 
tive. Device assignment is automatic for 
the required disc device. 

INPUT: An Object Module File (OMF) which is 
SYSUT2 out of the OMLU utility. This 
assignne nt is optional - see 'MODULES 
TO DELETE ?' message. 



OUTPUT: Disc resident OMF. 

Printer (SYSLST) - optional - See 
'MODULES TO DELETE ?^ message. 

PARAMETERS: No punched card parameters •• see 
'MODULES TO DELETE 7' message for 
console parameter format and options. 
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Programmer Considerations for Use of the Disc Object Module Library 



Maintenance Routine (DOMLMR) 



The DOMLMR program accepts an Object Module Library (OML) tape as 
Input and transcribes every module on the tape to disc. The output 
of a program translator (SYSUTl) Is an Object Module File (OMF) . To 
convert an OMF to an OML for use with DOMLMR, It Is necessary to 
run the Object Module Library Update (OMLU) routine. The Input to 
OMLU Is a SYSUTl tape, the output Is SYSUT2. The following example 
shows where the OMLU control cards go within a translator job 
stream. The parameters shown convert all the modules on SYSUTl 
to an OML for subsequent transcription to disc by DOMLMR. 

Once a module Is transcribed to disc, It will remain there until 
it is deleted via a console message. The program will not request 
modules for deletion when run under monitor. 

When a given module Is processed through DOMLMR, the module direc- 
tory on disc is searched to see if the module already exists. If 
it does, it is replaced by the new version. If it does not exist, 
it Is added to the file. The only restriction to the use of the 
DOMLMR is that MODULES CONTAINING A SORT MAY BE TRANSCRIBED TO 
DISC, BUT THE LINKAGE EDITOR WILL NOT BE ABLE TO LINK THEM BACK. 
If you do put a sort module out to the library, inform operations 
so that they may delete it to free up the disc space. 

// STARTM 
// JOB 
// PARAM 

// translator (ASSMBL, COBOL, FORTRN, RPG) 

SOURCE DECK (MODA) 
// translator 

SOURCE DECK (MODS) 

// EXEC OMLU 
COPY NONE 
CATALO SYSUTl 
END 

// EXEC DOMLMR 
// LNKEDT 
PROG MODAB 

INCLUDE SYS0ML(MODA,MODB) 
// ENDMON 
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MODA and MODE will be cataloged as separate modules. If MODA 
or MODB or both must be re-translated at a later date, the'// 
EXEC OMLU' thru V/ ENDMON' control cards remain the same. For 
example, if MODB required re- translation. It would be transcribed 
to disc, following OMLU, and then linked with the original version 
of MODA. 
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MAINTENANCE DOCUMENTATION FOR DOMLMR 



The logic used to reformat a given record type (00-05) 
on the input tape OML for the disc resident OML was 
determined by manual R/A edit comparison after CLTR to a 
tape edit of the input OML. The reformat logic as determined 
by this process is explained in appendix A. The same method 
is quite reliable for determining a problem which may be 
uncovered in DOMLMR today. As of the time this document 
is being written, DOMLMR is maintaining over 200 modules on 
a 70/590 without a problem. 

I recommend that prior to any change to DOMLMR, you thoroughly 
familiarize yoiorself with this program via the documentation 
provided. A brief description of each of the sub processing 
logic modules used is provided along with a detail logic chart. 
Appendix A and B should also be reviewed prior to going 
through the main line code of the detail logic charts. 

The GETEM macro, which prints out at the front of the assembly 
listing, is used for random access device assignment to elim- 
inate the need for run time parameters. The function of this 
macro is to build an extent matrix for the VSN and file name 
indicated at, in this case, tag NAME3. 
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The only program change required to implement this utility 
is the VSN number located at tag NAME3. The program is 
preset for 70/564 use and modifies itself for 70/590 use if 
that is the device assigned. 

The main line code of the program has notes indicated on the 
logic chart by double circles which are keyed to the notes 
themselves. The Sub Processing Notes section is keyed to 
sections by name and a more explanatory logic chart has been 
drawn. The Sub Processing Notes are designed for handy reference 
during your analysis of the main line code to explain the action 
taken by the 'BAL' blocks. 
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PREOML PROGRAM NARRATIVE 



The PREOML utility is used to preformat the disc extent used with 
the DOMLMR program. This utility will preformat a 70/590 or 
70/564 disc. The GETEM macro is used for device assignment. 
The volume serial number of the volume to be initialized is at 
tag NAME 3 card number 02990. The following operations are per- 
formed by this program: 

1. Verify that the extent starts on cyl 1 track zero and 

is allocated in full cylinder increments. If the program 
is being run to extend an existing area, the new ending 
cylinder number must be greater than the old ending 
cylinder number. 

2. Write 1688 or 1129 byte records of all hex zero to every 
track in the extent (4 records of 1688 bytes per track 

for 70/590 or 3 records of 1129 bytes per track for 70/564) . 

3. The first record of the Directory is formatted as indicated 
in appendix A. All records in the Directory are chained 
together by position 1-5. The records in cyl 2 through 

n are not chained. 

4. The control record is contrructed and written to track 
nine cylinder one. The cylinders that are allocated are 
set to hex zero in the track table of the control record. 
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The portion of the track table representing area be- 
yond the allocated area is set to hex '77' for 70/564 
or hex 'FF' for 70/590 to indicate full. 
5. When PREOML is run to extend on existing extent, the 
newly acquired area is preformatted with dummy records 
and the control record is updated to reflect the new 
extent limits. 
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SUB PROCESSING NOTES 

SECTION NAME: MOVE LOGIC ENTRY POINT: MOVE 

FUNCTION: This logic will move the number of bytes specified 

by the half word constant following the BAL instruc- 
tion from the address contained in GR 4 to the address 
contained in GR 5. If the field to be moved is larger 
than the remaining bytes in the output area (GR 6) , 
the field moved is split to fill up the current output 
block, that block is written to disc, and the remainder 
of the field is moved to the start of the next block. 
After the move is complete, GR 4 and GR 5 are incremented 
by the number of bytes moved. 

SECTION NAME: WRITE LOGIC ENTRY POINT: WRITE 1 

CLEAR 
CLEAROT 

FUNCTION: This logic will write the block contained in OTARA to 

disc. It uses the Table To Address (TTOA) logic to 

determine the 'write to' address on disc. The address 

(CCHHR) of the next logical record is placed in 

position 1-5 of the current output record unless the 

switch at tag OTSW is turned on. When the record is 

written, GR 6 is set to indicate a full block and GR 5 

is set to OTARA+8 in preparation for the next move. The 
2-5 



first disc 'write to' address is generated by the TTOA 
logic called in the 01 processing for "initialization. 
This routine is entered at tag CLEAR in the house- 
keeping logic and tag CLEAROT in the 01 logic. 

SECTION NAME: CALCUIATE NEXT AVAILABLE ENTRY POINT: TTOA 

CCHHR FROM TABLE 

FUNCTION: This logic generates a CCHHR address for disc based 

on the next available address in the track table por- 
tion of the control record. The generated CCHHR 
address is placed at tag DCCHH. If the extent is ex- 
hausted, it is detected in this logic. The number of 
remaining data records counter in the control record 
is decreased by 1. 

SECTION NAME: RESET USED BIT IN TABLE ENTRY POINT: ATOT 

BASED ON CCHHR ADDRESS 

FUNCTION: This logic sets the bit in the track table to off 

that corresponds to the CCHHR address at tag 'DCCHH'. 

The number of remaining data records counter in the 

control record is increased by 1. 

SECTION NAME: READ LOGIC FOR RECORD TYPE 00 ENTRY POINT: READO 

READ LOGIC FOR RECORD TYPE 01 ENTRY POINT: READl 

FUNCTION: The disc record specified by CCHHR in tag SEKADR+3 is 

accessed in OTARAOO for a GO record or OTARA for a 01 
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record. The address of the record just accessed 
(CCHHR) is stored for subsequent use by the REWRITE 
logic for 00 and 01 records. The CCHHR address in 
tag SEKADR+3 must be provided prior to entering the 
READ logic. 

SECTION NAME: USED TO REWRITE UPDATED ENTRY POINT: WRITEO 

00 RECORD 

USED TO REWRITE UPDATED ENTRY POINT: WRITEO 1 

01 RECORD 

FUNCTION: The record currently in core at tag OTARAOO for the 00 
record or OTARA for 01 record is written to disc at 
the address stored by a previous read (READO or READl) . 

SECTION NAME: LOCATE MODULE NAME IN 00 ENTRY POINT: DL00 

RECORD DL00D 

FUNCTION: The 8 byte module name at tag DELPRG is located in 

the directory. If the module name is not in the 

directory, the address returned points to the next 

sequential directory entry. The address of the left 

end of the directory entry in OTARA00 is returned in 

GR 1. A direct branch to tag DL00D is used in the 

print logic along with setting the switch at tag 

'PONLY' for the serial access of the directory. 

SECTION NAME: LOCATE 01 RECORD BASED ENTRY POINT: CHASE01 

ON 00 POINTER 



FUNCTION: The CCHHR address of the 01 record for the 00 record 
indicated by GR 1 is accessed into tag OTARA. GR 1 
is set to the CCHHR address in the 01 record which 
po-i ts to the first data record '"or the module. (See 
appendix A) . This module is dcriigned to be used 
following the DL00 logic. 

SECTION NAME: CHASE DATA RECORDS FROM ENTRY POINT: CHASE02 

01 TRANSACTION 

FUNCTION: Reset the corresponding bit in the track table to OFF 
for the 01 record just accessed and read and reset 
all corresponding bits for all 02 through 05 data 
block;: for the module. The last block for module 
will contain hex zero in pos 1 through 5. 

SECTION NAME: SHIFT 00 RECORD TO DELETE ENTRY POINT: SHIFT00 

ENTRY 

This logic shifts the 00 record at tag OTARA00 16 
positions left to eliminate an entry. GR 1 must point 
to the left end of the module to be deleted (set up by 
DL00 logic) . 

SECTION NAME: MODULE NAME PRINT ROUTINE ENTRY POINT: PRINTO 
FUNCTION: This logic prints a listing of all the module names 

contained in the directory. It is used in the deletion 
logic as a result of the PRINT operand. 
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HOUSEKEEPING SECTION 



The CLEAR logic is located in Che WRITE logic 
section. The OTARAOO and OTARA are cleared to 
hex zero. The return address from the CLEAR 
logic is a preset initial value of HSKP-f5 at 
tag ST14 which is loaded into GR14 at the end of 
the WRITE logic. 

This is done to prevent problems in the end of 
job logic in the event of a null input tape. 

All reads and writes to disc will BAL 14 to tag. 
RTRY in the event of an l/O error. This tag is 
located in the GETEM macro. The GETEM macro main- 
tains a count of the number of re-tries and types 
a message if the count is exhausted. 

The 'R' in the word 'DOMLMR' located in the control 
record (see appendix B) is used for a file lock/ 
unlock indicator. If the program terminates ab- 
normally, the file will be locked. This prevents 
DOMLMR from changing data in the file until the 
maintenance programmer can analyze the problem. 
The indicator is reset by re-establishing the file 
with DDRL. 

Control record verification is made by a compare 
of the constant 'DOMLMR' to the first six positions 
of the control record read. See appendix B for 
the format of the control record. 

If the ending CCHH in the extent matrix does not 
match the CCHH in the control record, the program 
terminates. Probably caused by the size of the 
extent being extended by RAALR and not running 
PREOML to update the control record and preformat 
the new area prior to running DOMLMR. 

The 'R' in the word 'DOMLMR' is reset at this point. 
When the control record is written back to disc at 
normal end of job, it will unlock the file. 



The date in the executive is compared to the date 
in the first record in the Directory. See Directory 
Record format in appendix A. 

Because the module names entered via the console 
can be variable length, they must be expanded to 
eight positions prior to searching for them in 
the Directory. 

Tlie comparison of tag DELPRG to the address in 
GR I indicates if the module was found in the 
directory or not. (See DL00 logic.) 

The letters 'CCHHR' are placed in the Directory 
record in place of an actual disc address until 
the '01' (Index Record) is read from the input 
tape and on actual disc address is calculated 
for the 01. This compare was mainly used for 
debugging. 

Setting DELPRG to hex zero causes the DL0CJ logic 
to access the first directory block and point to 
the first directory record following the dummy 
record (see appendix A) . 

Setting the NOP switch in the DL00 logic causes 
serial access of every record of every block in the 
directory. 

PRINTO, the logic module that formats and prints 
the directory listing, uses logical level FOP. 
For this reason, the address generated by the DL00 
logic in GR 1 must be shifted to GR 5 to be saved. 

The high dummy Directory entry (see appendix A) 
signals end of job to the print logic module 
(PRINTO) and breaks the print loop. 

Tag DL00D is located in the DL00 logic module. 
Because the DL00 logic was last entered by a BAL 14 
(just prior to tag PLISTB) it will continue to re- . 
turn to that tag until it is reset by a BAL 14 
from another location. 
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The DTFSR for the input tape is set for unlabeled 
tape. The 3 EXCPW macros rewind the tape and 
position it in front of the first tape mark for the 
open macro. The DTFSR is also set for no rewind 
at open. 

The first data record following the tape mark on 
a tape OML is a special identifying record. 

OBJECT MODULE DIRECTORY BLOCK (00) PROCESSING 

General registers 5, 6 and 7 are loaded from tag 
REC00. OR 5 contains the starting address of 
OTARAOO+8 in the REC00 area. This value is used 
as the 'TO' address in the MOVE logic. After a 
move, GR 5 is incremented by the length of the 
move to set up for the next move. GR 6 contains 
the number of bytes that will fit in the current 
record. This register is decremented by the num- 
ber of bytes moved. GR 7 points to tag REC00. 
This is used to access reset values for the first 
two entries (GR 5 and 6) and to access the storage 
area for the CCHHR of the 00 record currently in 
core. (See READ0 and WRITE0 logic.) 

The MOVE logic will automatically write a record 
when the I/O area is full as determined by the 
remaining byte count in GR 6. This logic is not 
desirable for the GO record processing. By loading 
GR 6 with the value of 2000, this feature is not 
used. 

The NOP at tag MEX0 is set to go to tag EM0. 

The GO record contains multiple module names and 
is fixed length. The unused portion of the tape 
record following the last module name is filled 
with hex zero. In the event that the 00 record 
is full, GR 10 is loaded with the address of the 
last input record position plus 1. As GR 4 is 
moved from one module to the next, it is compared 
to GR 10 for equality. 

This switch is turned on at 'A' page 1 when a 
new module is to be added to the file. When the 
switch is 'on', the 00 record is rewritten to disc. 
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This switch is turned on when an entry was shifted 
out of the block to make room for an addition. 
(See tag OF00 page 7.) 

Go read the 01 record in the data position of the 
extent into OTARA. 

Go access all records for the module in the data 
position o£ the file and set the bits in the track 
table to not used. 

This block saves the current address of the module 
being processed in the tape input area. It then 
sets the 'TO' address for the move logic (GR 5) 
to the end of the OTARAOO area +1 and the 'FROM' 
address for the move logic to the last 16 byte 
entry in in the OTAROO (70th entry for 564, or 
105th entry for 590). 

The BAL to 'MOVE' at tag MAGN moves 16 bytes and 
increments GR 4 and GR 5 the length of the move. 

The switch at MEX0 is turned on when the last move 
is about to be made. The normal ON for this switch 
goes to tag EMO. The switch is altered to go to 
tag OF00B at tag ONFR on page 8. This setting is 
used if more than one directory block has to be 
accessed and shifted to make room for a module 
entry. 

GR 1 contains the address in the OTARA00 block of 
where the new module should be merged. A compare 
of GR 4 (from address of move) to GR 1 for equality 
determines the last module is about to be moved 
and sets the switch at MEX0 to break the loop. If 
GR 4 valve is less than GR 1, the error branch tag 
TERMDA is taken. 

If the error condition at note 29 is sensed, it is 
not an error if the module to be added belongs in 
the last position of the record. 

Record shifted out is determined by a compare of 
hex zero to the end of OTARAOO+1. If the area 
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contains hex zero, no record has been shifted out. 
If a record has been shifted out, it is put in the 
first entry of the next 00 block. 

GR 1 is set to the address of OTARA00+8 . This 
causes the logic at tag SHIFT00 to move every 
entry in the 00 record 16 bytes right to free up 
the first entry for the entry shifted out the end 
of the previous record. 
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Note Chart 
Number 



INDEX BLOCK (01) PROCESSING 



33 9 If multiple 01 blocks are read for a single 

module, they all contain the same indicators 
for the number of entries, externs and common 
as well as the same constant info. For that 
reason, this branch goes directly to the logic 
to move the 'N' fields contained in the second 
and following records. (See appendix A-4) 

34 9 This is the first call in the program for an 

address generation from the table. The TTOA 
logic generates the CCHHR of the first available 
disc address at tag DCCHH. The WRITE logic 
keeps track of the next available disc address 
to put in bytes 1 thru 5 of the current record 
by issueing all subsequent calls for logic 
module TTOA. 

35 9 The area OTARA is cleared to hex zero initially 

at this point. The WRITE logic clears this 
area after each WRITE. 

Note Chart INDEX BLOCK 01 PROCESSING 

Number 

36 .10 The 'move' logic will write the 01 record to 

disc if the output area is full. In this case 
pos 1-5 of the first 01 record will contain the 
CCHHR of the next 01 record. 

37 10 See the Utilities Manual for definition of SUB 

CODE in position 2 of the input tape for a 01 type 
record. 

38 10 Since 01 records are written under control of 

the WRITE logic used with the MOVE logic, the 
CCHHR of the next record is placed in pos 1-5 of 
the record. Control is transferred to this 
block when the last 01 record for the module 
has been constructed. Since this is the last 
data record for this module until the 02 record 
is later accessed from tape, it is so indicated 
by the hex zero in pos 1-5. Setting the switch 
in the WRITE logic inhibits the moves of CCHHR 
to overlay the hex zero. 
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Note Chart 
Number 

39 11 



Note Chart 
Number 

40 12 

Note Chart 
Number 

41 13 



Note Chart 
Number 

42 14 



OBJECT MODULE DESCRIPTOR BLOCK (02) 



The 02 records on tape represent the first 
record of a new module. The first 02 accessed 
will follow the last 01 record on tape and will 
cause the switch at tag D02 to be turned off. 
When the switch is off and an 02 record is read 
from tape, the last record for the previous 
module is written to disc with positions 1-5 
of that record set to hex zero as an end of 
module indicator. The number of used bytes in 
the record is also calculated and put into the 
record. 

EXTRN BLOCK PROCESSING (03) 



This move takes all the extrns in one move to 
the output record. GR 4 and 5 are set to the 
correct addresses by the previous move. The 
number of bytes to move is calculated in the 
logic at tag D03B. 

TEXT BLOCK (04) AND MODIFIER BLOCK (05) PROCESSING 



When the address of tag LEN04 is sent to the move 
logic in Gr 4, the move logic will check to insure 
that there is at least 10 bytes remaining in the 
output area prior to the move. If less then 10 
bytes remain, the current record is written to 
disc and the data in tag LEN04 is put at the 
front of the next record. This is done to 
insure that fields A thru D are not split over 
two records . 

END OF JOB PROCESSING 



Since the WRITE logic maintains the CCHHR of the 
next available disc address, it must be reset 
to unused at end of job. The table entry was 
initially set to used when the CCHHR was generated 
in the ATOT logic. 
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Input Record To Output Record Conversion 



See TOS Utilities Manual 70-35-302 (Object Module Library) for a 
description of the input tape. 

To illustrate the conversion from tape Object Module Library (OML) 
format to disc OML format, charts have been intersperced with the 
narrative. The space between each dot represents two bytes. The 
tape and disc positions indicated are zero relative. A field with 
no tape position indicated in the 'From Tape' line indicates infor- 
mation generated by the program. A layout with no 'To Disc' line 
indicates that the particular record type can be located anjrwhere 
within the data bytes alloted in each disc record. The first 8 
positions reflect the five position CCHHR address of the next logi- 
cal record for the module, followed by a three position hexideciiMl 
count field of the number of data bytes that are used. 

The basic processing is as follows: 

Record type (00) (Descriptor Block) - fixed length of 
16 bytes on disc. 

Each 16 byte entry is merged into a sequential location in 
one of the records located in cylinder 1 track 0 thru 8. 
Record type (01)j^6 (Index Block) - starts a new record 
in the data portion of the file (note 1) . 

Record type (02) 3^5 (Descriptor Block) - starts a new record 
in the data portion of the file (note 1) and is immediately 
followed on the output record by the next input transaction 
(03)i6, (04)i6 or (05)i6. 

Note 1: The data portion of the file is cylinder two track zero 

to end of extent for 70/590 and 70/564. This is the area 
covered by the track table contained in the DOMLMR 
control record. Cylinder one tracks zero thru eight 
contains the Obj ect Module Directory, cylinder one 
track nine is the DOMLMR control record. Cylinder one 
tracks eleven thru twenty are not used on the 70/590. 

Record 

Size: 70/590 is 1688 byte records - 4 per track - 1680 data 
portion. 

70/564 is 1129 byte records - 3 per track - 1121 data 
portion. 
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Object Module Directory Block (00) 
Disc Record Layout 
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Field Contents 

A. CCHHR of next Object Module Directory Block (next sequential 
record in cylinder one) . 

B. Three position byte count for this block - represents the sum 
of the 16 byte entries only. This field is calculated in the 
Object Module Directory Block Logic (OO)j^g. 

Fixed length entries of 16 bytes - one per module. 

C. Eight position module name. 

D. CCHHR of the corresponding Index Block in the data portion 
of the field, (established when the Index Block - (01) is 
read from tape.) 

E. Three position displacement of the Index Block within the 
record specified in field 'D*. (zero in all cases because 
each Index Block starts a new record) 

Genera 1 : 

1. The total record length is 1129 bytes (16 byte entries X 70 
entries per record ) + 8 control characters + 1 unused byte 
at the end of the record) for 70/564. For the 70/590 the 
total record length is 1688 bytes (16 byte entr'£es X 105 
entries per record) + 8 control characters. 

2. DOMLMR uses tracks 0 thru 8 of cylinder 1 to contain the 
Object Module Directory. 
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3. Entries do not overflow records. 

4. The first entry of the first record contains - 'OMLU 22 
10 YYJJJ' where YYJJJ is the year and Julian date of the 
last reference to the file by DOMLMR. 

5. The last entry of the Directory contains a module name of 
lozenges, a CCHHR of *CCHHR' and a displacement of hex zero 
except for 2' of the high order position. 
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Index Block (01) 
Disc Record Layout 



Field Contents 

A. CCHHR of first detail record for this module. Same as field 
'E'. Established when the (02)^5 record is read from tape. 

B. Byte count for this block - represents size of data portion 
only. 

C. Byte count for the record. 

D. Module name. 

E. CCHHR of first detail record for this module. (Same as field 
•A') Established when (02)j^g record is read from tape. 

F. Displacement of data in the record located at the CCHHR 
address indicated in field (zero in all cases because 
each Object Module descriptor Block (02) starts a new 
record) . 

G. Unused - pad with zero. 

H. Module length. 

I. Extern name. 

J. Starting address. 
K. DDNAME (for include) 
L. OMNAME (for include) 
M. Unused - set to zero. 

N. First 12 byte entry name (8 bytes) and starting address 
(4 bytes). This field is repeated for each entry, extern 
and or common for this module. 

General: 

I. Each Index Block begins a new record. 
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The ladex Block is variable length as determined by number 
of entries, externa and common, (total entries, externs, 
and common X 12 Bytes per entry + 50). 

The address of the Index Block record is determined by the 
table search logic in the TTQA logic. 
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Disc Record Layout 
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Field Contents 

A. CCHHR of next record for this module or hex zero If this Is 
the last record for the module. 

B. Block length - Initially set to the maximum data bytes to 
reflect a full record In the (02) 15 processing. Reset to 
adjusted length when the next (02)15 is read or the end of 
the input tape Is read In the End of Job Logic. 

C. Record length - 'OOOE' for (02)15 record. 

D. Block Code (02)^5 

E. Type of block that follows (See Utilities Manual for code 
explanation.) 

F. Hex zero - reserved for future use. 

G. Module name. 
Genera 1 : 

1. Each Object module Description Block begins on a new record. 
It will be immediately followed by one of the other record 
types (03i5-05i5) 

2. The CCHHR address of this record is contained in the corres- 
ponding Index Block (01) fields A and E. 



EXTRN Block (03) ig 

Disc Record Layout 
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Field Contents 

A. Length of (03) record - starting in tape relative position 
12 is a variable number of 11 byte EXTRNS. This length is 
computed in the 03 logic by multiplying the number of these 
11 byte entries by 11 and adding 6 additional bytes for the 
fixed length portion of the disc record. 

B. Block Code - (03) 15 

Co Block Subcode (See Utility Manual for code explanation) 

D. Filler - not used. 

E. EXTRN 

F. Type Code 
6. ESID 
Genera 1 

1. Fields E, F and G represent one EXTRN. These fields are 
repeated for each EXTRN. 

2. The EXTRN block may be located ansrwhere in the data portion 
of a disc record and may overflow records. 
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Text Block (0^)i^ 
Disc Record Layout 
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Field Contents 

A. Length of (04)10 record = this size is calculated by adding 6 
bytes to the ' Block Byte Count ' field positions 2 and 3 of the 
(04) record. 

B. Block code (04)]^^ 

C. Block Subcode (See Utilities Manual for code explanation.) 

D. Load address of next block. 

E. Text - variable size - up to 1044 bytes . 
Genera 1 

1. The move logic will insure that fields A, B and C will fit on 
the end of the current output record when field 'A' is moved. 
To accomplish this the current output record must have 10 or more 
bytes remaining prior to the 'A' field move. If it does not 
have sufficient room, the length of the current output record 
(OTARA + 6 and 7) is modified, the record is written to disc 
and the 'A' field is placed in the next record starting in 
OTARA + 8. 



2. The 04 record may reside anywhere in the data portion of a 
disc record and may overflow records. 



Modifier Block (05) 
Disc Record Layout 
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Field Contents 

A. Length of (05) record - this size is calculated by sub- 
tracting 4 from the length of the tape record read. 

B. Block Code (05)^6 

C. Block Subcode (See Utilities Manual for code explanation.) 

D. Load address of next block. 

E. Modifier count. 

F. Modifiers - 10 bytes each. The length of this variable 
portion of the record is calculated by subtracting 12 from 
the length of the input record. (See Utilities Manual for 
contents of modifier record.) 

Genera 1 

1. The 05 record may reside anywhere in the data portion of 
disc record and may overflow records. 

2. Fields A thru E may not be split, the balance of the input 
record may be. 
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CONTROL RECORD FORMAT 



THIS RECORD IS CONTAINED ON CYLINDER I, TRACK 9, RECORD 1 

FIELD POSITION . SIZE DESCRIPTION 

1 0-5 6 RECORD IDENTIFIER (DOMLMR) 

2 6-9 4 CCHH OF LAST TRACK IN EXTENT 

3 10-12 3 5% OF ORIGINAL NUMBER OF RECORDS 

AVAILABLE „ PROGRAM WILL TYPE WARNING 
MESSAGE WHEN FIELD 5 BECOMES EQUAL 
TO OR LESS THAN THIS AM)UNT, (PACKED) 

^ 13-16 4 NOT USED - FOR RAEDIT ALIGNMENT ONLY. 

5 17-19 3 NUMBER OF UNUSED RECORDS IN DATA 

PORTION OF FILE (PACKED). 

6 20-2019 2000 ONE BYTE REPRESENTS 2 TRACKS. THE TOP 

HALF OF THE TYPE (2^-2^) REPRESENTS 
RECORDS 1 THRU 3 (RELATIVE) FOR THE ODI 
NUMBERED TRACKS. THE BOTTOM HALF OF 
THE BYTE (2^-2^) REPRESENTS RECORDS 
I THRU 3 (RELATIVE) FOR THE EVEN 
NUMBERED TRACKS. BITS 2^ AND 2' 
REPRESENT RECORD 4 FOR THE 70/590. 
A 1 BIT INDICATES RECORD IN USE, A 0 
BIT INDICATES RECORD NOT IN USE. 
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